home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 22 / Amiga Format AFCD22 (Jan 1998, Issue 106).iso / -seriously_amiga- / shareware / programming / other / gui4cli / docs / 3.2_changes < prev    next >
Text File  |  1997-11-17  |  7KB  |  200 lines
  1.  
  2.  
  3.    ******************** VERSION 3.2 CHANGES *******************
  4.  
  5.  
  6. --------------- CHANGES AFFECTING GUIS OF PREVIOUS VERSIONS:
  7.  
  8.   Only one change, which will not greatly affect your guis :
  9.  
  10.   Now a gui's variables are considered to be PRIVATE by default, 
  11.   i.e. without having to previously issue the VARPATH command.
  12.   It's more straight forward this way.
  13.  
  14.   If you have any problems, just add the global command: 
  15.   - VARPATH '*' - to your guis. 
  16.   If you still have problems you must trace down the variables you 
  17.   want to have as Global, and put a * in front of them.
  18.  
  19.  
  20. --------------- HELP:
  21.  
  22.   Now help for gadgets is available through the gadget modifier :
  23.   >  GADHELP 'This is some help text'
  24.  
  25.   To turn the help system on/off you can hit the HELP key, or give 
  26.   the command SET HELP ON|OFF
  27.  
  28.  
  29. --------------- NEW EVENTS:
  30.  
  31. - xPIPE  PIPE:FileName  ON|OFF
  32.   will launch a new process which will open and monitor a pipe: file
  33.   and will send you any output that any program redirects to it in
  34.   the form of lines of text via the internal variable $$PIPE.TXT
  35.   - SetGad now has a new keyword CLEAN, used *only* for pipes.
  36.  
  37.  
  38. --------------- NEW COMMANDS:
  39.  
  40. - xLVINSERT RecordNumber string
  41.   will insert the given string *before* the given record. 
  42.   RecordNumber of -1 means the CURRENT record. 
  43.  
  44. - BREAKTASK TaskName CDEF (signals) signals a task named TaskName
  45.   with a given combination of signals - like if you used the Amigados
  46.   break & status commands together. Usefull for stopping programs.
  47.  
  48. - SET DEEPTRANS ON|OFF - setting DEEPTRANS OFF will stop Gui4Cli from
  49.   translating variables within variables - this will last for one
  50.   execution cycle. This comes useful in the filetype checking routines
  51.   which are now much faster.
  52.  
  53. - PARTREDRAW GuiName L T W H - will redraw only part of the window.
  54.   Use this if you're just changing some gadgets in one area of the
  55.   window and do not want a full redraw. It's easier on the eyes..
  56.  
  57. - SETGADVALUES GuiName - will store the values of all the gadgets of
  58.   a gui into their respective variables. This is usefull at the 
  59.   start of a gui, when you have to set the default values of your
  60.   variables.
  61.  
  62.  
  63. ---------------- VISUAL EDITING IMPROVEMENTS:
  64.  
  65. - CONTROL-J while in GUI Visual Editing mode, will now clone the 
  66.   gadget in it's own window.
  67.  
  68. - A GRID is now available, which makes lining up the gadgets much
  69.   easier. By default the grid size is 1 which means "no grid".
  70.   You can set the grid size with "SET GRID 5" (5 is a good size..)
  71.  
  72. - Gui4Cli will now adjust the position of ghosted gadget you move 
  73.   around while editing, to keep it inside the window borders. This
  74.   does not effect inter-gui cloning which works as usual.
  75.  
  76. - Various small bugs were exterminated (see bug-fixes below).
  77.  
  78.  
  79. ---------------- TEXT IMPROVEMENTS:
  80.  
  81. - CTEXT last argument (the mask for underline|bold|italic) now works...
  82.   Also, it has 2 more digits :
  83.   Digit #4, is the color number of the "shade" which the letters will be 
  84.             shaded with, producing a 3D effect.
  85.   Digit #5, is the size of the shade (defaults to 1)
  86.   You need not declare these two.. 
  87.  
  88. - Also in CTEXT, if you give -1 as the background color, the background
  89.   will not be disturbed. Useful for writing over an Image background..
  90.  
  91. - CTEXT, WINFONT and GADFONT now also recognise the following :
  92.   - #MONO    specifying the default Monospace font, and
  93.   - #SCREEN  specifying the Screen font, which is usually proportional.
  94.   It is best to use these two in GUIs which you want to distribute.
  95.  
  96.  
  97. --------------- LISTVIEWS:
  98.  
  99. - COLORED, fancy text can now be seen in listviews! (only WB 3.0+)
  100.   Listviews will now interpret and render all the console sequences 
  101.   which set text color and mode (bold etc). See "Important Topics".
  102.   (also read this text with it..)
  103.  
  104. - A new type of listview "SHOW" which is exactly like "TXT", except 
  105.   that the selected choice will remain highlighted.
  106.  
  107.  
  108. --------------- DIRECTORY LISTVIEWS:
  109.  
  110. - DIR ListViews will now show you the directory sizes next to the
  111.   dir name, if you issue a LVAction ..SIZE.. command.
  112.  
  113.  
  114. --------------- EXTENDED VARIABLE NOTATION:
  115.  
  116. - NORMAL variables now have extended notation:
  117.  
  118.   - Private    GuiName/VarName[start][length]
  119.   - Globals    *VarName[start][length]
  120.  
  121.   Apart from the VarName bit, all other components are optional.
  122.   Read all about it in "Important Topics"
  123.  
  124.  
  125. --------------- NEW INTERNAL VARIABLES:
  126.  
  127. - $$WIN.PATH will tell you the path of the current or infoed gui.
  128.   (same as extract gui guipath var)
  129.  
  130. - $$GAD.VAR is the name of the variable that the given gadget will
  131.   store it's value in.
  132.  
  133. - $$G4C.DEFSCREEN - The screen name which all guis get (default = '*')
  134. - $$G4C.OUTPUT - The default console output spec
  135. - $$G4C.FILEPATTERN - The default ASL requester file pattern
  136. - $$G4C.EDITOR - The default editor name (c:Ed)
  137. - $$G4C.GUIPATTERN - The dafault gui extension (#?.gc - for the requester)
  138. - $$G4C.GUILOADDIR - The dir that the G4C load requester will open at
  139.  
  140.  
  141. --------------- ARGUMENTS FOR ROUTINES:
  142.  
  143. - New and powerfull improvement (read "GOSUB/GUILOAD" in the guide):
  144.  
  145.   Commands which call other events (like Guiload which calls xOnLoad,
  146.   or GoSub which calls a routine) can now take up to 6 arguments which 
  147.   are passed to the routine the given command calls, in the form of 
  148.   Internal variables $$ARG.0 to $$ARG.5. -OR- (if defined in the 
  149.   event's command line) automatically converted to variables.
  150.  
  151.   $$ARG.TOT contains the actual number of arguments passed. 
  152.  
  153. - Furthermore, RETURN can also now return from the routine or xONLOAD
  154.   etc, with up to 6 more arguments, which are passed back to the 
  155.   calling GoSub or GuiOpen etc as internal vars $$RET.0 to $$RET.5.
  156.  
  157.  
  158. --------------- SCREENS:
  159.  
  160. - Up to now, the screen name that Gui4Cli used if no Screen had
  161.   been declared for a gui was "Workbench". Now it's the "*" character
  162.   which means "The Front Most Screen". i.e. now, your guis will open
  163.   by default on the front most screen.
  164.  
  165. - This default screen name can be changed with :
  166.   SET  DEFSCREEN  Workbench   (or whatever..)
  167.   Note : This is *not* the same as the OS's default screen..
  168.  
  169.  
  170. --------------- BUG FIXES:
  171.  
  172. - Fixed redrawing of windows when being resized which sometimes
  173.   left trash at the bottom of the window.
  174.  
  175. - UNLOADIMAGE which did not seem to work in version 3.1, is actually
  176.   called FREEIMAGE. (yes.. I'm not perfect.. it was a big suprise to 
  177.   me too..)
  178.  
  179. - Fixed some bugs in $$lv.rec and LVSearch/LVFind commands.
  180.  
  181. - Fixed some bugs in GuiEdit. The Cyclers/radios will now save correctly.
  182.   ** HOWEVER ** if you add a cycler or radio (by cloning it) and save the 
  183.   gui, you'll have to reload it before you can edit it again, because
  184.   these gads add lines to the gui and Gui4Cli will think it's an error.
  185.   Also fixed some other stuff..
  186.  
  187. - Fixed SetWinTitle command which effected the titles of other windows.
  188.  
  189. - Added a version string for the c:version command.
  190.  
  191. - Fixed extract EXT which did not remove quotes
  192.  
  193. - Optimised command linking when loading file - Loading should now be
  194.   faster by a nano-pico-millisecond or two...
  195.  
  196. - Fixed a bug with the initial size of the resizable borders which 
  197.   showed up when using the VisualPrefs program (which changes the screen
  198.   structure border sizes).
  199.  
  200.